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Overview 

A new table-driven mechanism is being provided to analyze 
the status returned by the IOM for peripheral devices and to 
report on error conditions found in the status. This mechanism 
is designed primarily for those devices which are driven through 
the I/O Interfacer, but it is not limited to such devices. A 
status interpretation table for each different type of peripheral 
device is required. A primitive is provided which is given the 
name of the peripheral device, the IOM status, and a pointer to 
the status interpretation table. This primitive will report all 
error conditions found in the status via calls to com _err . The 
primitive will also return 18 bits of information to its caller 
to aid in determining what action should be taken on the basis of 
the status. 



Anal yzi ng termina t ion status 

When termination status indicating an error is returned by 
the IOM, the following call can be made to analyze the status: 



del analyze__device__stat__ entry (char (*.), ptr, bit (72) 
aligned, bit (18) aligned); 



call analyze_device_stat__ (devname, tablep, iom__status , 



flags) ; 



devname 



is the name of the device for which status 
has been received. It is used as the first 
argument passed to com._err__, (Input) 



tablep 



is a pointer to the status interpretation 

table for the device. See section below for 

a description of the status Interpretation 
table format. (Input) 
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ion__ status is the 72 bits of status returned by the IOM. 

(Input) 

flan-s are 18 bits of information designed to aid 

the caller in deciding how to act on the 
status. Currently, two bits are defined: 
substr (flags, 1, 1) is used to indicate that 
the I/O operation for which status was 
returned should be re-executed 

unconditionally. substr (flags, 2, 1) will 
cause substr (flags, 1, 1) to be set if the 
initiation bit in the IOM status is on. That 
is, it will force an indication that the I/O 
operation for which status was returned 
should be re-executed only if it failed 
during initiation of the operation. (Output) 



Mote that analyze_.device__stat__ should not be called with IOM 
status that does not indicate an error condition. An error bit 
is provided for such purposes by the I/O Interfacer. Other users 
should determine that one or more of the following fields in the 
IOM status bits are nonzero before calling analyze__rievice_stat_: 
power, major status, IOM central status, IOM channel status. 



Analyzing system fault status 

Certain serious IOM errors do not cause termination status 
to be stored. Instead, they cause an IOM system fault which 
returns IOM system fault status to the user. This condition is 
indicated by an IOM interrupt level of 1. In this case, a 
different call should be made to analyze the status information: 

declare analyze__system_fault__ entry (char (*), bit (72) 
al igned ) ; 

call anaiyze_systen__fault__ (devname, iom_status ) ; 
(Arguments are as above.) 



Status Interpret ation Table 

The status interpretation tables for each device are coded 
in mexp. L'ach table consists of a header, and an array of 
substatuses for each major status which the device can venerate. 
The format of the table header is as follows: 

declare 1 stable (15) based (tablep) aligned, 
2 offset bit (18) unaligned, 
2 count fixed bin (17) unaligned; 
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stable is an array which contains an element for 

each possible major status. 

offset is a relative pointer to the structure 

describing this major status and its possible 
substatuses, If offset is zero, the 
corresponding major status is not expected 
for this device. 

count is a count of the different substatuses 

expected for this major status. 

Each major status and its associated substatuses are 
described by the following structure: 

declare 1 sinfo based (sp) aliened,. 
2 maj char (24 ) , 
2 sub ( count) , 

3 control char (6), 

3 flags bit (13) , 

3 desc char (32); 

sinfo is the structure. 

maj is a description of the major status. 

sub is an array of substatuses expected for this 

major status . 

control is 6 characters of information describing the 

substatus bit configuration. Onlv three 
characters are permitted in the control 
string: "0", "1", and r, X" . In order for a 
given substatus to match a table entry, each 
0 " or " V in the control string must be 
matched by a corresponding !; 0" or I! 1 " bit in 
the substatus. Bits corresponding to "X" 
characters are not compared. 

flags are 18 bits of information which can be used 

to determine what action should be taken for 
this status. See above for a description of 
the defined flag bits. 

desc is a description of the substatus. 
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Statu s In terpretatio n Table Generation Macros 



Three macros are provided for the purposes of generating a 
status interpretation table for a device. The first of these is 
designed to generate the table header. The other two generate 
the major status and substatus information structures. 



status table 



devname , ( control ) 



This macro sets up the table header and defines a seedef so 
that the table can be externally accessed symbolically. It also 
causes the symbols "backup 11 and "initiate" to be defined as 



400000 octal and 
setting the flags. 



200000 octal respectively. These are used in 



devname 



is the name of the device for which a status 
interpretation table is to be generated. The 
segment is given a name of 

devname_status__table" . The table header can 
be found at the se^def 

''devname status table". 



control 



is a string of 15 numbers seperated by 
commas. A zero indicates that the 

corresponding major status is not expected 
for this device. A nonzero number indicates 
that the corresponding major status is 
expected and information describing that 
major status will appear in the status 
interpretation table* 



status. entry ma j,( description) 

This macro sets up the major status description. 

maj is the major status being described. Note 

that this number is decimal. 

description is a character string describing this major 
status. 

sub st a t _ent ry maj , control , flags, (description) 

This macro sets up infomation for substatus. 

maj is the major status for which this substatus 

applies. Note that this number is decimal. 

control is 6 characters controlling the examination 

of the substatus as described above. 
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flags are the 18 bits of action flags described 

above. This number is octal. It nay also be 
described symbolically. 

description is a character string describing this 
substatus . 
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Appendix 

The mexp macro definitions are ?iven below for reference: 



" Macro definitions for peripheral status table generation. 
; ' created 12/1/7^ by Noel I. Morris 



&macro s.tatus_table 

name &1 status table 



segdef 



&1 status table 



bool 
bool 



backup ,400000 
initiate , 200000 



retry previous operation 
set backup flaff if initiate 



&1__status table 
&(2 
ifend 



i fend 
&) 

&(2 

i fend 
'*) 

&end 



ife 
zero 



me 
zero 



me 
set 



&i ,0 
0,0 

&i ,0 

m&x , im&x 



&i ,0 
lm&x , 0 



& macro 
m&1 : 
&end 



status entry 

aci ' li &2",24 



&macro sub stat__en try 

set In&l ,ln&1+1 

aci "&2 :r ,6 

vfd o18/&3 
aci ,32 



or end 



MTB-145 



Page 7 



Example 

The following is an example of a status interpretation table 
for the card reader-: 



" CRZ STATUS__TABLE - Status Tables for the Card Reader, 
coded 12/1/74 by Noel 1/ Morris 



' - ********** ****************** 

i! * * 

ir * * 

11 * Copyright (c) 1972 by Massachusetts Institute of * 

* Technology and Honeywell Information Systems, Inc. * 

ii * * 

if * * 

1 1 ************ ************* ******************* ********** 



&include status table 



status table 



crz,( 1 , 1 , 1 ,0, 1 ,-0,0,0,0, 1 , 1 , 0, 1 ,0,0) 



status entry 



1 , (Device Busy) 



status__entry 

substat_entry 
subs.tat_entry 



sub stat 

substat_ 

substat. 

substat. 

substat 



.entry 
..entry 
_entry 
_entry 
_entry 



2, (Device Attention) 

2, 000000., initiate /(Device off line) 

2, XXX0X1 , initiate, 

(Hopper emoty or Stacker full) 

2, XXXQ1X, initiate, (Manual Halt) 

2, 0X10XX, initiate, (Feed Alert) 

2, 1X10XX, initiate, (Sneak Feed) 

2, X1X0XX, backup, (Card jam) 

2, 1X00XX, backup, (Read Alert) 



status_entry 

substat._en'try 

substat__entry 
substat_entry 
substat entrv 



3, (Device Data Alert) 

3 ,000001 , backup , 

(Transfer timing error) 

3, 000X10, backup T ( Validity check) 

3, 0001X0, backup . (Dual read alert) 

3 , 001000 , backup ,( Feed without read) 



status_entry 



5, (Command Reject) 
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substat__entry 
substat_entry 

substat__entry 

status_entry 

substat_entry 
substat_entry 
substat_entry 

substat_entry 

status _en try 

substat_entry 

substat_entry 

status_en try 
substat... entry 
substat en try 
substat_en try 



5 , 0000X1 , backup-, ( Invalid op code) 

5, 00001X, backup, 

(Invalid device code) 

5, 000100, backup, (IDCW parity error 



10, (MPC Attention) 

10,000001 , initiate, (IAI error) 

10,000010, initiate , (DAI error) 

10 ,000100 , initiate , 

(DA Transfer error) 

10,001 000, initiate, (Invalid Punch) 



11, (MPC Data Alert) ' ■ 

1 1 , 000001 , backup , 
(Transmission parity error) 
1 1 ,000101 , backup, (DAI error) 



13, (MPC Command Reject) 

13,000001 , backup, 

(Illegal procedure) . 

13, 000010, backup, 

(Illegal logical channel) 

13, 00 1000, backup . (Device reserved) 



end 



